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AUTOMATED  DOCUMENTATION 
SYSTEM  (ADS)  STUB  GENERATOR: 
DESCRIPTION  AND  USER 
INSTRUCTIONS 


1  INTRODUCTION 


Background 

A  useful  software  tool  is  the  product  of  a  carefully 
managed  and  executed  software  development  project. 

In  1979,  the  U.S.  Army  Construction  Engineering 
Research  Laboratory  (CERL)  introduced  a  computer 
system  to  help  guarantee  successful  management  and 
execution  of  Army  software  development.  This  sys¬ 
tem,  called  the  Automated  Documentation  System 
(ADS),  allows  internal  and  external  documentation  to 
proceed  simultaneously  with  software  development.1 

The  ADS  Stub  Generator  is  a  subsystem  of  ADS. 
It  lets  the  software  project  manager  define  which 
ADS  documentation  sections  must  be  in  the  final 
software  code.  It  also  lets  the  manager  monitor 
updated  ADS  documentation  as  the  initial  software 
code  is  amended  and  extended. 

This  report  describes  how  to  use  the  ADS  sub¬ 
system  Stub  Generator.  The  text  is  geared  to  the 
data  processing  professional  and  assumes  the  reader 
is  familiar  with  Control  Data  Corporation  (CDC) 
FORTRAN  and  UPDATE  and  the  ADS  computer 
system  as  described  in  CERL  Technical  Report 
(TR)  E-147. 

Objective 

The  objective  of  this  study  was  to  develop  a  method 
to  ensure  structured  program  development  and 
adequate  documentation  by  automatically  generating 
standard  program  stubs. 

Mode  of  Technology  Transfer 

The  ADS  Stub  Generator  is  available  from  the 
Boeing  Computer  Services  (BCS)  Company  under 
the  U.S.  Army  Corps  of  Engineers  contract  for 
scientific  and  engineering  teleprocessing. 


■Linda  Lawrie.  The  Automated  Documentation  System  — 
User  Manual.  Technical  Report  E-147/ ADA067203  (U.S.  Army 
Construction  Engineering  Research  laboratory,  February  1979). 


2  OVERVIEW 


Stubs  are  skeletal  routines  which  contain  routine 
headers,  preliminary  ADS  documentation,  type  state¬ 
ments,  common  block  references,  initial  debugging 
output,  and  RETURN/  END  statements.  The  Stub 
Generator  relieves  some  of  the  drudgery  of  creating 
these  routine  stubs  by  building  skeleton  FORTRAN 
modules  containing  standard  UPDATE  directives,  ba¬ 
sic  FORTRAN  code,  and  ADS  comments  from  data 
entered  by  the  user.  These  skeleton  modules  are  kept  in 
the  UPDATE  source  program  library.  They  can  be 
amended  or  extended  as  the  system  is  developed. 

First  Session 

During  the  first  Stub  Generator  session,  the  user 
(usually  the  software  project  team  leader)  sets  the 
desired  level  of  internal  program  documentation  by 
specifying  the  required  ADS  documentation  sections 
(see  Appendix  A).  At  this  time,  the  team  leader  can 
also  set  basic  “system  parameters”  for  the  software 
being  developed;  once  set.  some  of  these  system 
parameters  cannot  be  changed.  For  example: 

1.  The  name  of  the  system  (in  the  form  of  a 
three-character  prefix  which  is  used  to  generate 
file  names) 

2.  The  password  (if  any)  associated  with  system 
files 

3.  The  control  character  to  be  used  on  UPDATE 
directives. 

A  complete  list  of  parameters  which  can  and  can¬ 
not  be  changed  after  the  first  Stub  Generator  session 
is  in  Appendix  A,  Figure  A1 .  Appendix  A  also  gives  a 
sample  of  an  initial  Stub  Generator  session. 

History  File 

The  system  history  file  is  maintained  by  the  Stub 
Generator.  It  has  ail  the  data  needed  to  describe  a 
software  system  to  the  Stub  Generator  (Figure  1). 
It  includes: 

1 .  A  list  of  all  options  in  effect  during  the  last  Stub 
Generator  session 

2.  Data  on  modules  already  named  or  described  to 
the  Stub  Generator  subsystem 

3.  Data  needed  to  create  instructions  to  update 
and  sort  the  source  program  library. 
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Figure  1.  Stub  Generator  system  overview. 


Creating  Program  Modules 

During  the  creation  of  program  modules,  the  Stub 
Generator  prompts  the  programmer  for  information 
needed  to  define  each  program  module.  The  Stub 
Generator  ensures  adequate  internal  program  documen¬ 
tation  hy: 

1 .  Prompting  with  the  ADS  section  headers  in  the 
order  specified  by  the  software  manager  during  the 
first  session. 

2.  Verifying  the  specified  ADS  section  for  the  type 
of  module  being  defined.  After  the  required  ADS 
comments  are  given  to  the  Stub  Generator,  the 
programmer  may  input  additional  ADS  sections, 
if  desired. 


Two  UPDATE  files  can  be  created  during  each 
Stub  Generator  session.  One  has  preliminary  UP¬ 
DATE  directives  (such  as  *ID  or  *AF)  and  any 
modules  defined  as  COM  DECKS.  The  other  has 
UPDATE  directives  and  source  code  for  any  modules 
defined  as  DECKS. 

Both  files  arc  kept  on  disk  until  a  programmer  tells 
the  Stub  Generator  to  put  them  in  the  source  program 
library.  (For  more  details,  see  the  explanation  of  the 
@D  command  in  Chapter  4.) 

After  the  Stub  Generator  is  told  to  update  the 
source  program  library,  it  generates  a  file  of  control 
cards.  These  cards  are  used  to  begin  the  proper  job 
stream.  (This  file  is  sent  to  the  job  queue  internally. 
However,  the  Stub  Generator  will  save  this  file  as 


6 


a  disk  file  to  be  batched  by  hand,  if  requested.)  Once 
the  job  begun  by  these  control  cards  is  complete,  any 
update  files  will  be  purged;  the  newly  sorted  source 
program  library  will  be  saved  and  a  printed  report  of 
the  final  source  library  will  be  output. 

If  the  option  to  run  ADS  is  in  effect  when  the 
control  card  file  is  created,  the  control  card  job  will 
also  create  and  keep  two  ADS  files.  It  will  also 
produce  any  ADS  reports  requested. 

A  sample  programmer  session  is  given  in  Appendix 
B.  (Actual  usage  of  the  Stub  Generator  will  differ 
from  facility  to  facility.  Commands  for  beginning  a 
session  on  Boeing  Computer  Services’  (BCS)  EKS 
system  are  given  in  Appendix  C.) 

Pile  List  and  Function  Description 

Figure  1  shows  the  overall  file  system  for  the 
Stub  Generator. 

The  system  help  file  contains  the  online  help 
messages  that  are  given  in  response  to  the  @H 
command  (Chapters  4  and  5). 

The  system  error  message  file  contains  the  online 
help  messages  pertaining  to  error  messages  issued  by 
the  Stub  Generator.  These  messages  are  given  in 
response  to  the  @  M  command  (see  Chapters  4  and  5). 

The  control  card  file  contains  the  job  stream 
that  is  generated  and  submitted  by  the  Stub  Gener¬ 
ator.  This  file  may  be  saved  as  a  permanent  disk 
file.  If  the  user  asks  the  Stub  Generator  to  save  the 
control  card  file,  the  permanent  file  name  will  be 
generated  by  concatenating  the  user-supplied  prefix 
with  CNTL  (for  three-character  prefixes),  OCNTL 
(for  two-character  prefixes),  and  LOCNTL  (for  one- 

SUBROUTINE  SUBl(X.Y) 

IF  (TRACE)  CALL  TRACER  (4HSUB1.1) 

IF  (PARAMS)  WRITE  (DEBUG,*)  X,Y 

IF  (PARAMS)  WRITE  (DEBUG,*)  X,Y 
IF  (TRACE)  CALL  TRACER  (4HSUB1.2) 
RETURN 
END 


character  prefixes).  The  batch  job  that  is  submitted 
will  generate  printed  output  and  a  sorted  UPDATE 
source  program  library  (OL.DPL).  The  OLDPL  con¬ 
tains  all  of  the  source  code  for  the  software  system  in 
a  special  UPDATE  format. 

The  ADS  master  and  invert  files  will  also  be 
created  if  the  RUN  ADS  option  is  in  effect.  These 
files  contain  information  about  the  code  in  the  source 
program  library  needed  to  generate  ADS  reports. 

Options 

The  Stub  Generator  optionally  inserts  initial  debug¬ 
ging  features  when  the  skeleton  modules  (Figure  2) 
are  created.  These  features  “trace”  program  paths  and 
parameter  passing. 

The  initial  debugging  features  are  controlled  by  the 
logical  variables  TRACE  and  PARAMS.  These  vari¬ 
ables  (along  with  the  variable  DEBUG*)  are  assumed 
to  be  in  the  standard  debug  common  block  of  the 
software  system  being  developed.  The  TRACE  and 
PARAMS  flags  can  be  turned  on  or  off  internally 
during  debugging.  Besides  TRACE.  PARAMS.  and 
DEBUG,  the  Stub  Generator  assumes  that  the  soft¬ 
ware  system  has  a  routine  called  TRACER. 

Using  these  variables  and  the  routine  TRACER, 
the  Stub  Generator  automatically  creates  the  code  to 
trace  program  paths  and  display  passed  parameters  at 
routine  entries  and  exits. 

Help 

Two  system  message  files  explain  error  messages 
and  tell  the  user  what  the  causes  of  the  error  might  be. 
The  online  help  features  are  invoked  by  the  @H  and 
@M  commands.  (For  details,  see  Chapters  4  and  5.) 

—generated  other  statements  including 
the  DEBUG  common 

—  entry  trace 
—entry  parameters 

—  other  code 

—  exit  parameters 
—exit  trace 


Figure  2.  Sample  Stub  Generator  debugging  statements. 
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3  CAPABILITIES  AND  LIMITATIONS 


The  Stub  Generator  automatically  generates  all  the 
UPDATE  directives  needed  to  (I)  create  a  source 
program  library,  (2)  add  new  modules,  or  (3)  purge 
existing  modules.  As  module  names  are  mentioned 
(either  as  the  module  is  defined  or  in  a  context  which 
identifies  the  module  type),  it  builds  a  history  of 
names  to  warn  users  of  possible  conflicts  (e.g.,  using 
duplicate  module  names,  using  the  same  name  in  a 
context  that  implies  different  routine  types,  or  creat¬ 
ing  a  subroutine  call  to  a  defined  subroutine  whose 
argument  list  has  a  different  number  of  arguments 
than  the  defined  subroutine). 

For  example,  if  a  new  module  is  given  the  same 
name  as  a  module  already  in  the  system,  the  Stub 
Generator  will  inform  the  user  that  the  named  module 
exists  and  ask  if  he/ she  wants  to  purge  the  existing 
version.  The  history  may  also  detect  usage  conflicts, 
such  as  naming  a  module  previously  defined  as  a 
function  in  a  generated  subroutine  call,  and  a  few 
possible  error  conditions,  such  as  a  conflict  between 
the  number  of  formal  parameters  given  in  the  module 
definition  and  the  number  of  parameters  given  in  the 
argument  list  of  a  generated  subroutine  call  to  that 
previously  defined  module. 

Flexible  Features 

1.  The  Stub  Generator  accepts  card  image  input 
for  ADS  comments.  This  lets  the  user  exercise  all  the 
formatting  capabilities  in  ADS. 

2.  Generated  subroutine  calls  and  user-defined 
code  (e.g.,  comments,  calculations,  and  function  calls) 
can  be  put  in  any  order  in  the  body  of  the  routine.  The 
Stub  Generator  asks  for  subroutine  calls  and  other 
code  and  requires  consecutive  negative  responses  to 
both  requests  before  completing  the  module.  The  Stub 
Generator  will  automatically  include  "RETURN"  or 
"STOP’  and  "END”  statements  as  needed. 

3.  The  UPDATE  source  library  (OLDPL)  is  out¬ 
put  in  a  standard  order  of  COM  DECKS,  main 
programs,  and  subroutines  and  functions.  To  ask  (or 
a  nonstandard  ordering,  the  user  assigns  a  level  from 
I  to  3  to  each  module  when  it  is  defined.  The  OLDPL 
will  then  be  created  in  the  order: 

a.  COM  DECKS 

b.  Level  3  routines 


c.  Level  2  routines 

d.  Level  1  routines. 

Each  subgroup  of  either  OLDPL  ordering  is  kept  in 
alphabetical  order.  Module  levels  are  stored  in  the 
Stub  Generator  history  file  and  their  order  main¬ 
tained  as  modules  are  added  or  deleted. 

4.  Permanent  files  can  be  accessed  under  an  alter¬ 
nate  user  number.  Thus,  the  OLDPL  and  the  basic 
system  history  file  can  be  generated  and  maintained 
under  a  master  account,  and  be  accessed  by  several 
different  subsidiary  accounts. 

5.  A  full  update  of  the  ADS  master  files  is  always 
done  when  an  ADS  run  is  requested.  This  ensures 
that  all  possible  changes  are  included.  (The  Stub 
Generator  creates  an  ADS  batch  job  to  do  this; 
see  pp  6,  7.)  But  if  the  user  is  working  with  a  pre¬ 
existing  OLDPL  (or  if  there  are  a  number  of  com¬ 
pleted  modules),  it  may  be  better  to  run  ADS  jobs 
more  tailored  to  the  specific  update  needs  outside  of 
the  Stub  Generator. 

Limitations 

1.  The  Stub  Generator  has  no  file  editing  capa¬ 
bilities  other  than  a  very  limited  line  replacement  for 
the  job  control  stream  and  backspacing  one  input 
line.  Any  big  change  should  be  made  by  a  separate 
UPDATE  run  or  by  redefining  the  defective  module. 

A  module  is  redefined  by  entering  its  name  in 
response  to  the  request  for  the  next  routine  name  and 
by  allowing  the  STUB  Generator  to  purge  the  old 
routine.  (Modules  cannot  be  purged  or  redefined  on 
the  first  run,  since  the  purge  directive  is  not  valid 
when  a  new  OLDPL  is  being  created.)  The  Stub 
Generator  does  not  interactively  update  the  OLDPL; 
rather,  it  generates  input  files  of  directives  and  creates 
a  batch  job  from  a  user  session  to  accomplish  the 
actual  OLDPL  modification. 

2.  Because  the  Stub  Generator  is  not  a  FORTRAN 
compiler,  a  clean  compile  is  not  guaranteed  by  gener¬ 
ating  a  module.  For  example,  if  the  software  system 
being  developed  is  to  automatically  include  TRACER 
calls,  the  user  must  define  "TRACE”  as  a  logical  vari¬ 
able  in  a  standard  debug  COM  DECK  which  must  be 
included  in  each  of  the  system’s  routines.  If  this  is 
not  done,  a  FORTRAN  compile  error  will  occur. 
To  include  automatic  unformatted  parameter  writes. 
“PARAMS”  must  be  defined  in  the  same  way 


•The  output  unit  for  the  software  system's  debugging  output. 
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as  TRACE.  TRACE,  PARAMS,  and  the  standard 
debug  COM  DECK  refer  to  the  special  initial  de¬ 
bugging  outlined  in  the  overview.  The  debug  COM- 
DECK  name  is  defined  during  the  first  Stub  Generator 
session  and  maintained  in  the  Stub  Generator  history 
file  (see  Chapter  2). 

Figure  2  is  a  sample  of  the  debugging  statements 
created  by  the  Stub  Generator. 

Output 

Batch  job  output  lists  (1)  all  active  cards  in  the 
OLDPL,  (2)  any  FORTRAN  compilation  errors,  and 
(3)  any  ADS  reports  requested.  If  an  ADS  run  was 
not  requested,  only  the  OLDPL  list  will  be  output. 
A  sample  batch  job  submitted  by  the  Stub  Generator 
is  given  in  Appendix  D. 


4  COMMAND  LANGUAGE  AND 
ONLINE  HELP 


Nine  commands  ask  for  special  action  from 
the  Stub  Generator.  The  command  syntax  is  a 
immediately  followed  by  a  one-letter  command  (or 
the  full  command  word).  Table  1  explains  each 
command. 

The  online  help  commands  (@H  and  @M)  tell  the 
user  what  type  of  information  the  Stub  Generator  is 
asking  for  or  what  type  of  errors  might  account  for  a 
particular  error  message. 

The  @H  command  gives  clues  about  the  type  of 
information  the  Stub  Generator  is  currently  request- 


Table  1 

Stub  Generator  Commands 


Abbreviation 

Full  Command 

Explanation 

@A 

@ABORT 

Aborts  the  Stub  Generator  program  without  saving 
any  of  the  current  work  files. 

@B 

@ BACKSPACE 

Backspaces  one  record  on  the  last  file  written.  This 
command  must  be  used  carefully.  It  may  not  be 
possible  to  backspace  to  the  correct  place  since  the 
Stub  Generator  maintains  several  files  simultaneously. 
If  a  different  prompt  has  intervened  since  the  record 
to  he  replaced  was  displayed,  le  g  .  1  •.  M  ~*.  I''),  the 
buckspucc  command  may  not  work  properly.  How¬ 
ever.  errors  can  be  fixed  by  doing  a  standard  UP¬ 
DATE  run. 

@C 

@COMMANDS 

Lists  the  available  commands;  this  list  is  displayed 
on  the  terminal. 

@D 

@DONE 

Begins  normal  end-of-job  processing  to  generate  and 
submit  a  batch  job  to  update  the  OLDPL  (and  run 
ADS.  if  requested). 

@E 

<®ECHO 

Toggles  echoing  of  lines  input. 

@H 

@HELP 

Asks  for  online  help  giving  more  information  on  the 
question  -urrentlv  being  asked  of  the  user. 

@M 

(ffiMESSAGE 

Asks  for  online  help  giving  more  information  on  the 
last  error  message  given  to  the  user. 

(ffiMESSAGE.#### 

Asks  for  online  help  for  a  particular  error  message 
identified  by  a  four-digit  code  (####). 

<§>P 

(SPRINT 

Prints  the  last  line  input  by  the  user. 

<®S 

@SAVE 

Saves  the  user’s  work  files  and  run  options  without 
beginning  a  batch  run.  The  user  can  then  input  more 

definitions  later. 
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ing.  It  also  tells  the  user  what  publications  to  refer  to 
for  more  detailed  explanations  or  syntactical  rules. 

The  @M  command  has  two  forms:  both  give 
extended  error  messages.  (Extended  error  messages 
give  a  detailed  statement  of  the  error,  possible  causes, 
and  names  of  appropriate  reference  manuals.)  Enter¬ 
ing  M”  will  result  in  an  extended  error  message  for 
the  last  displayed  error  message.  Extended  error 
messages  may  be  retrieved  by  typing  “@M.dddd.” 
where  “dddd"  is  the  four-digit  code  preceding  the  brief 
message  for  which  the  user  is  requesting  additional 
information 

Up  to  three  levels  of  help  may  be  available  for  any 
particular  question  or  error  message.  A  “+”  at  the  end 
of  a  help  section  tells  the  user  that  additional  help 
is  available. 


of  COM  DECKS  called  in  a  routine  is  entered  as 
“COM I,  COM2,  COM3,”  the  Stub  Generator  will 
ask  the  user  for  another  input  line.  The  user  then  can 
add  more  COMDECK  names. 

5.  If  the  batch  job  submitted  by  the  Stub  Gener¬ 
ator  fails  for  any  reason,  the  user  should  try  to 
resubmit  a  corrected  run  before  initiating  a  new  Stub 
Generator  session.  The  exception  is  when  an  abort 
has  occurred  after  an  OLDPL  manipulation.  In  this 


Table  2 

ADS  Categories  and  Valid  Abbreviations 
ADS  Documental tion  Categories 


Category  Abbreviation 


5  GENERAL  HINTS 


Title  TIT 

Common  block  title  COM  TIT 


1.  A  null  line  (RETURN)  is  the  same  as  a  nega¬ 

Author 

AUT 

tive  response  for  Y/  N  questions,  except  during  the 
first  run  of  the  Stub  Generator,  when  basic  system 

Date  Written 

DAT 

parameters  are  defined.  During  this  first  run,  the 
default  for  all  parameters  is  Y. 

References 

REF 

Location 

IOC 

2.  The  Stub  Generator  will  output  an  UPDATE 
input  file  for  an  existing  OLDPL  when  the  user 

Method 

MET 

exits  a  session  with  the  (®S  command.  The  user 
should  then  edit  the  UPDATE  input  files  to  make 

Control  cards 

CON 

sure  the  *AF  directives  indicate  the  correct  order 

Remarks 

REM 

for  the  OLDPL.  The  permanent  file  names  of  the 

System 

SYS 

update  input  files  are  created  by  concatenating  the 

user-supplied  prefix  with  DTE  I  and  DTES  (for  a 
three-character  prefix),  PDTE1  and  PDTES  (for 

Flow 

FLO 

a  two-character  prefix),  or  UPDTE1  and  U PDTES 

Files 

FIL 

(for  a  one-character  prefix).  For  example,  if  the 
software  prefix  is  “SAM.”  the  UPDATE  input  files 

Algorithm 

ALG 

are  SAMDTEI  and  SAMDTES.  The  user  can  then 
create  a  new  job  stream  to  begin  the  UPDATE  run. 

System  dependencies 

SYS  DEP 

Nonsystem  externals 

NON  SYS  EXT 

3.  Abbreviations  can  be  used  to  name  both  re¬ 
quired  and  optional  ADS  sections.  Valid  abbrevia¬ 

Machine  dependencies 

MAC  DEP 

tions  arc  usually  made  from  the  first  three  characters 
of  the  section  name  (Table  2). 

Implementation  dependencies 

IMP  DEP 

Variable  dictionary 

VAR 

4.  When  the  user  ends  a  list  format  with  a  comma, 
it  tells  the  Stub  Generator  that  the  user  wants  to 
add  more  data  to  the  list.  For  example,  if  a  list 


Revised  (dale) 


REV 

PUR 
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Purpose 


case,  the  user  should  purge  the  work  files.  Any 
missing  output  can  then  be  retrieved  by  beginning  the 
appropriate  job  outside  of  the  Stub  Generator.  If  the 
output  is  not  retrieved  in  this  way.  it  will  be  produced 
during  the  next  successful  Stub  Generator  run. 

6.  Three  types  of  prompts  are  produced  by  the 
Stub  Generator  and  give  a  clue  to  the  type  of 
input  expected: 

i>  This  is  the  standard  prompt  indicating  that 
a  reply  to  the  current  question  is  desired. 
The  type  of  input  desired  is  generally  indi¬ 
cated  in  the  question  itself  or  in  the  online 
help  (@H). 

M>  This  prompt  indicates  the  Stub  Generator 
is  ready  to  accept  multiple  input  lines.  The 
lines  will  be  accepted  as  80-column  card 
image  lines.  No  processing  of  the  line  will 
be  done  other  than  to  write  it  to  the 
appropriate  file. 

CD  This  prompt  indicates  the  Stub  Generator 
is  ready  to  accept  a  card  image  input  of 
an  ADS  comment.  The  CD  is  used  as 
columns  1  and  2  of  the  line  written  and 
need  not  be  repeated  by  the  user. 


7.  The  Stub  Generator  gives  two  classes  of  error 
messages:  warning  and  error.  Warning  messages 
generally  tell  the  user  the  Stub  Generator  has  detected 
a  special  condition  and  has  taken  corrective  action,  is 
expecting  special  input  (i.e.,  continuing  input  follow¬ 
ing  a  line  ending  with  a  comma),  or  has  detected  a 
condition  that  may  result  in  an  error  (i.e.,  an  incorrect 
number  of  arguments  on  a  subroutine  call  to  an 
already  defined  subroutine).  Fatal  error  messages 
indicate  a  severe  error  that  must  be  corrected  and 
re-input  before  processing  can  continue. 

6  SUMMARY 

The  Stub  Generator  gives  the  software  develop¬ 
ment  manager  who  relies  on  ADS  a  way  of  standard¬ 
izing  documentation  during  all  phases  of  project 
development.  By  setting  specific,  unchangeable  ADS 
documentation  standards  during  the  first  Stub  Gener¬ 
ator  session,  the  manager  guarantees  that  minimum 
documentation  goals  will  be  met,  no  matter  how  often 
the  software  is  amended  or  extended.  The  Stub 
Generator  also  lets  the  manager  monitor  project 
progress  easily  and  reliably.  The  programmer  is  also 
given  a  convenient  way  of  creating  program  systems 
in  a  top-down  structural  manner  through  the  genera¬ 
tion  of  standard  program  stubs. 
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APPENDIX  A: 

SAMPLE  FIRST  SESSION 


The  parameters  which  define  the  basic  characteristics  of  the  software  being  developed  are  set  during  the  first 
Stub  Generator  session.  This  first  session  is  usually  done  by  the  software  development  team  leader.  The  team 
leader  can  control  the  system  characteristics  and  the  basic  ADS  documentation  by  setting  parameters  which 
cannot  be  changed.  In  the  sample  session  in  this  appendix,  the  system  parameter  library  was  saved  by  using 
the  @S  command.  The  team  leader  could  also  choose  to  define  the  standard  debug  common  block  and  the 
TRACER  routine  to  be  used  by  the  system  and  begin  the  batch  run  to  create  an  OLDPL  by  ending  the  session 
with  the  @D  command. 

The  prompt  to  the  user  is  “I>”.  If  nothing  is  shown  on  that  line,  the  user  used  only  the  RETURN  key.  This 
key  defaults  to  “YES”  or  the  value  indicated  in  Figure  A I . 

(hinge 


Parameter 

Default 

Yes 

No 

Description 

Master  Account 

None 

X 

User  id  under  which  system  parameters  were  defined  and  where  OLDPL  and  system 
library  are  maintained  by  system. 

System  Prefix 

None 

X 

3  user-specified  characters  that  are  appended  to  the  front  of  standard  file  names  to 
create  names  uniquely  identifying  files  belonging  to  a  particular  system. 

Password 

Null 

X 

Password  associated  with  system-maintained  permanent  files. 

Update  Control 
Character 

• 

X 

Character  appended  to  the  front  of  UPDATE  directives. 

ADS  Required 
Sections 

None 

X 

User-specified  list  of  ADS  sections  that  are  to  be  generated  for  each  module  defined. 
Specified  headers  will  always  be  generated  even  if  no  input  is  received  for  that  section. 

Account  Password 

Null 

X 

Password  associated  with  user  id  under  which  user  is  currently  running. 

List  Control 

Yes 

X 

Controls  generation  of  “*IF  -DEF.  (mod  name),!’’.  “C  1.IST.NONE”  and  “*IF 

DEF,LISTALL’’.‘‘C  LlST.AL.l.’’,  statements  to  allow  control  of  source  listing  in 

compiler  output. 

Implicit  Integer 

Yes 

X 

Controls  generation  of  “IMPLICIT  INTEGER  (A-Zf  statement. 

Standard  Debug 

Deck 

Yes 

X 

User  may  request  the  generation  of  “•CALL”  to  a  user-specified  debug  comdeck  in 
all  DECKS  defined. 

Debug  Deck  Name 

DEBUGR 

X 

Name  of  user-defined  debug  comdeck  to  be  specified  on  “•CALL". 

Standard  OLDPL 
Order 

Yes 

X 

Standard  order  =  comdecks,  main  routines,  subroutines/ functions  in  alphabetical 
order  within  each  group.  User  may  request  control  of  ordering  of  all  modules 
except  comdecks. 

Nonpropagating 

Comdecks 

Yes 

X 

Controls  generation  of  "NOPROP"  parameter  on  ’“COMDECK"  directive. 

t 


Parameters  lhal  (.annul  be  changed  afler  the  first  session  arc  ’’system  parameters."  Changeable  parameters  arc  "run-time  options." 


Figure  AI.  Stub  Generator  -  first  session  sample. 


12 


Chant' 


Parameter 

Default 

Yea 

No 

Description 

TRACT R  Calls 

Yes 

X 

Controls  generation  of  calls  to  a  user-defined  TRACER  routine  upon  entry  and  exit 
to  subroutines/ functions.  Provides  a  subroutine  trace. 

l)  nf  or  matted 
Parameter  Trace 

Yes 

X 

Controls  generation  of  unformatted  write  statement  with  1  O  list  of  formal  parameters 
upon  entry  and  exit  to  subroutines. 

Comdeck  Define 
Name 

COMM 

X 

Name  to  be  used  in  generation  of “*1F  DEF.”  directive  precedinga  block  of  ADS  code 
in  comdecks.  Allows  suppression  of  listing  of  comments. 

Routine  Define 

Name 

ROUT 

X 

Name  to  be  used  in  generation  of  “*IF  DEF,”  directive  precedinga  block  of  ADS  code 
in  decks.  Allows  supression  of  listing  of  comments. 

ADS  Run 

Initiation 

Yes 

X 

Controls  initiation  of  execution  of  the  ADS  program  to  generate 1  update  master 
documentation  files  and/or  produce  ADS  reports.  ADS  runs  will  always  redocument 

all  modules  defined  in  the  old  OLDPL.  If  the  generator  is  being  used  to  generate 
stubs  for  an  existing  system  or  only  reports  are  desired,  it  would  be  more 
efficient  for  the  user  to  initiate  an  ADS  run  separately. 


+ 


Parameters  that  cannot  he  changed  after  the  first 


session  arc  "system  parameters  "  Changeable  parameters  are  “nm-nme  options. ” 


Figure  Al.  (Cont’d). 
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we leone  to  the  be s  network 
your  access  port  is  cix  67 


select  desired  service:  eksl 
80/07/09.  07.51.30. 

EH S 1  760C.N04d0.d3AA  8O/0d/29.DS-0  18.55.11.  80/07/08. 

MMNMMMMPMM 

TERMINAL  27,  TTY 
RECOVER/USER  ID:  jeanb 

***  MEU  SCHEDULE  FOR  NOS  1.4  IMPLEMENTATION.  SEE  MSG, NOS  *** 

C  >get ,pr of i 1 /un3c  er005 

Ocall , , jist<naster=cer084,sys=san,pw=test) 

07.55.04.  UELC0ME  TO  JEAN'S  INTERACTIVE  STUBMAKER! 

07.55.04.  HANG  ON  WHILE  I  CRANK  IT  UP. 

ADS  STUB  GENERATOR 

INSTRUCTIONS?  <T/N) 

I>y 

THE  ADS  STUB  GENERATOR  SYSTEM  IS  DESIGNED  AS  AN  AID  TO  A  SYSTEMS 
DESIGN  TEAM  IN  THE  INITIAL  STAGES  OF  DEVELOPING  A  FORTRAN  SYSTEM. 
SYSTEM  PARAMETERS  ARE  REOUESTED  FROM  THE  USER  TO  DETERMINE  OPTIONS 
DESIRED,  AND  FOR  USE  UITH  PERMANENT  FILE  FUNCTIONS.  THESE  OPTIONS  ARE 
RETAINED  BETWEEN  RUNS.  SOME  OPTIONS  NAY  BE  CHANGED  BY  THE  USER  AT  THE 
BEGINNING  QF  A  RUN. 

MOST  REQUESTS  ARE  SELF-EXPLANATORY.  IF  ADDITIONAL  HELP  IS  REQUIRED, 
THE  USER  HAY  REFER  TO  THE  USER'S  GUIDE  FOR  MORE  DETAILED  INFORMATION, 
OR  REQUEST  ON-LINE  HELP  FOR  THE  SPECIFIC  QUESTION  OR  ERROR  MESSAGE. 

UP  TO  THREE  LEVELS  OF  ON-LINE  HELP  ARE  AVAILABLE.  A  FOLLOUING  A 
SECTION  OF  TEXT  INDICATES  MORE  HELP  FOR  THAT  ITEM  IS  AVAILABLE  AND 
MAY  BE  RETRIEVED  BY  REPEATING  THE  SAME  COMMAND  (I.E.,  OH  FOR 
ADDITIONAL  HELP  ON  THE  CURRENT  QUESTION,  OR  IN  FOR  ADDITIONAL 
HELP  ON  AN  ERROR  MESSAGE). 

AVAILABLE  COMMANDS: 

PA  QABORT  ABORT  PROCESSING 

IB  IBACK  BACKSPACE  ONE  RECORD  ON  LAST  FILE  WRITTEN 

PC  ICOMMANDS  PRINT  LIST  OF  AVAILABLE  COMMANDS 

PD  8D0NE  NORMAL  END  OF  JOB  PROCESSING 

PE  8ECH0  TOGGLES  ECHOING  OF  INPUT  LINES 

PH  IHELP  REQUEST  ON-LINE  HELP  FOR  CURRENT  QUESTION 

PH  8MESSA0E  REQUEST  ON-LINE  HELP  FOR  LAST  ERROR  MESSAGE  ISSUED 

PM, IBM  MESSAGE, IBM  REQUEST  OF  ON-LINE  HELP  FOR  SPECIFIED  ERROR 

MESSAGE 

PP  IPRINT  PRINT  LAST  LINE  INPUT 

PS  8SAVE  SAVE  CURRENT  FILES  AND  EXIT  PROGRAM 


♦•WARNING:  4700  INVALID  TID 


ABORT  SESSION?  <Y/N) 

I>n 

5  UPDATE  CONTROL  CHAR? 

I> 

6  ADS  REQ  SECTIONS?  (NANE1 ,NAME2, . . . fNANEN/NONE) 

1> 

7  ACCT  PU? 

I> 

8  AUTO  LIST  CONTROL  STNT?  (Y/N) 

1> 

9  AUTO  INPLICIT  INTEGER?  (Y/N) 

I> 

TO  AUTO  STB  DEBUG?  (Y/N) 

I> 

11  DEBUG  DECKNANE? 

I> 

12  STD  OLDPL  ORDER?  (Y/N) 

I> 

13  AUTO  NOPROP  COHDECKS?  (Y/N) 

I> 

14  AUTO  TRACER  CALLS?  (Y/N) 

I> 

15  AUTO  PARAMETER  TRACE?  (Y/N) 

I> 

14  A IS  CONDECK  BEF  NAME? 

I> 

17  ADS  ROUTINE  BEF  NAME? 

I> 

18  RUN  ADS?  (Y/N) 

I> 

LIST  SYSTEM  PARAHS?  (Y/N) 

I>V 

SYSTEM  PARAMETERS: 


2  MASTER  ACCT  ID?  :  CER084 

3  SYS?  (3  CHARS  MAX)  :  SAN 

4  PM?  :  TEST 

5  UPDATE  CONTROL  CHAR?  :  * 

6  ADS  REQ  SECTIONS? 

1*  ADS  COMBE CK  DEF  NAME?  :  COMM 

17  AIS  ROUTINE  IEF  NAME?  :  ROUT 

LIST  RUN  OPTIONS?  (Y/N) 

i>y 


RUN  OPTIONS: 

8  AUTO  LIST  CONTROL  STMT?  (Y/N)  :  Y 

9  AUTO  IMPLICIT  INTEGER?  (Y/N)  :  Y 

10  AUTO  ST)  IEBU8?  (Y/N)  :  Y 

11  DEBUG  DECKNANE?  :  BEBUOR 


• 


»2  STD  OLDPL  ORDER?  (Y/R)  s  Y 

13  AUTO  ROPROP  CONDECKS?  (Y/N)  :  Y 

14  AUTO  TRACER  CALLS?  (Y/N)  :  Y 

15  AUTO  PARAMETER  TRACE?  (Y/N)  :  Y 

18  RUN  ADS?  (Y/N)  .  Y 

ART  CHAR6ES?  (Y/R) 

i>y 

ENTER  ALL,  «  OR  <CR> 

1>6 

6  ADS  RED  SECTIORS?  (NARE1 ,RANE2, . . . ,RANEN/NORE) 
I>tit,co«  tit,aut,dat 
ENTER  ALL,  •  OR  <CR> 

I> 

LIST  SYSTEM  PARANS?  (Y/R) 

I>V 

SYSTEN  PARAMETERS: 

2  MASTER  ACCT  ID? 

3  SYS?  (3  CHARS  MAX) 

4  PU? 

5  UPDATE  CONTROL  CHAR? 

6  ADS  REQ  SECTIORS? 

TITLEZ* 

COMMON  BLOCK  TITLE! 

AUTHOR!* 

DATE  WRITTEN!* 

1A  ADS  COMDECK  DEF  NAME? 

17  ADS  ROUTINE  DEF  NAME? 

LIST  RUN  OPTIONS?  < Y/N) 

I>n 

ANY  CHANGES?  (Y/N) 

I>n 

MODULE  NAME? 

I  >05 

OK.  JUST  A  SECOND.  I'M  A  SLOU  WRITER. 

08.00.42.  CONE  AGAIN! 

EXIT. 

C> 


:  CER084 
:  SAM 
:  TEST 


:  COMM 
:  ROUT 


l(i 


APPENDIX  B: 
SAMPLE  RUN 


The  sample  run  in  this  appendix  has  examples  of  basic  features  like  help  commands  and  how  to  input  ADS 
comments.  A  sample  version  of  a  TRACER  routine  and  a  debugging  common  block  have  been  entered  in  this 
session  and  a  batch  run  was  begun  to  create  an  OLDPL.  The  job  stream  generated  for  the  batch  job  is  shown 
on  p  24.  This  version  uses  KCL  procedures,  which  restrict  the  range  of  valid  UPDATE  characters  that  can  be  used 
as  the  UPDATE  control  character.  Only  the  characters  A-Z,  0-9,  and  *  can  be  passed  as  parameters  to  the 
procedures  in  the  standard  profile.  The  Stub  Generator  will  only  generate  input  files  for  UPDATE  runs  using 
other  valid  UPDATE  control  characters  if  the  user  creates  a  new  job  stream  outside  the  Stub  Generator. 

Prompts  to  the  user  are  “1>”,  “M>",  and  “CD".  If  nothing  is  shown  on  the  prompt  line,  the  user  has  entered 
only  the  RETURN. 
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ADS  STUB  GENERATOR 


INSTRUCTIONS?  (Y/N) 

I>n 

7  ACCT  PM? 

I>blastu 

LIST  SYSTEM  PAR AMS?  (Y/N) 
I>y 


SYSTEM  PARAMETERS: 


2  MASTER  ACCT  ID?  :  CER084 

3  SYS?  <3  CHARS  MAX)  :  SAM 

4  PU?  :  TEST 

5  UPDATE  CONTROL  CHAR?  :  * 

6  ADS  REQ  SECTIONS? 

TITLES- 


COMMON  BLOCK  TITLEZ* 

AUTHORS* 

DATE  WRITTEN!* 

16  ADS  CONDECK  DEF  NAME?  :  CONN 

17  ADS  ROUTINE  DEF  NAME?  :  ROUT 

LIST  RUN  OPTIONS?  (Y/N) 

i>y 

RUN  OPTIONS: 

8  AUTO  LIST  CONTROL  STMT?  < Y/N)  :  Y 


9  AUTO  IMPLICIT  INTE6ER?  (Y/N)  :  Y 

10  AUTO  STD  DEBUG?  (Y/N)  :  Y 

11  DEBUG  DECKNANE?  :  DEBUGR 

12  STD  OLDPL  ORDER?  (Y/N)  :  Y 

13  AUTO  NOPROP  COHBECKS?  (Y/N)  :  Y 

14  AUTO  TRACER  CALLS?  (Y/N)  :  Y 

15  AUTO  PARAMETER  TRACE?  (Y/N)  :  Y 

IB  RUN  ADS?  (Y/N)  :  Y 

ANY  CHANGES?  (Y/N) 

i>y 

ENTER  ALL,  «  OR  <CR> 

I  >6 


****ERROR:  2200  OUT  OF  BOUNDS 
ENTER  ALL,  N  OR  <CR> 

I>@M 

NUMERIC  VALUE  OF  USER  INPUT  EXCEEDS  MINIMUM  OR  MAXIMUM 
ALLOWABLE  VALUE.* 

I>Qn 

EXAMPLE; USER  INPUT*?  FOR  OLDPL  LEVEL,  VALID  VALUES  ARE  1-3. 

OR  USER  SPECIFIED  A  QUERY  NUMDER  TO  CHANGE  AN  OPTION  THAT 
IS  EITHER  NOT  1-18  OR  IS  NOT  CHANGEABLE  ON  THIS  RUN 
(SYSTEM  PARAMETER). 
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-j 

i 

i 


1> 

LIST  SYSTEM  FARMS?  (Y/N) 

I>n 

LIST  RUN  OPTIONS?  (Y/N) 
l>n 

ANY  CHANGES?  (Y/N) 
l>n 

NODULE  DANE? 

I >debugr 

NODULE  TYPE?  (C,P,F,S) 

I>@h 

C  -  CONDECK 
P  -  FR08RAN 
F  -  FUNCTION 
S  -  SUBROUTINE 
I>c 

CONNONS  DEFINITION?  (Y/N) 

I>y 

N>  connon  /debugr/  debug, trace, par ant 

N> 

TYPE  STATEMENTS?  <Y/N) 
i>y 

N>  integer  debug 
N>0b 

N>  integer  debug 

N>  logical  trace ,parans 

N>c 
H> 

DIMENSION  STATEMENTS?  (Y/N) 

I>n 

ADS  -  REQUIRED  SECTIONS 


CD  CONNON  BLOCK  TITLES8 

CD  debugr  -  debugging  variable  connon 

CD 

OPTIONAL  SECTIONS?  (SEC1 ,SEC2, .. .SECN/NONE) 

I>var 

CD  VARIABLE  DICTION ARTS8 

CD  debug!  debug  file  nane 

CDcd  traces  logical  variable  for  routine  tracing  calls  to  tiner 
CD  paransS  logical  variable  for  paraneter  tracing 
CD 

OPTIONAL  SECTIONS?  (SEC1 ,SEC2t... SECN/NONE) 

I > none 

CONDECK  CALlS?  ( NANE I , NAHE2 , . . . , NANE N/NONE ) 

I>none 

OTHER  CODE?  (Y/N) 

I>n  i 

NODULE  NANE? 

I>tracer 

NODULE  TYPE?  <CfP,F,S> 
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I 

PARAMETER  LIST?  (PI ,P2, . . .PN/NONE) 

I>sname,f lag 

TYPE  STATEMENTS?  (Y/N) 

I>n 

DIMENSION  STATEMENTS?  (Y/N) 

I>n 

ADS  -  REQUIRED  SECTIONS 


CD  TITLE** 

CD  tracer  -  standard  subroutine  trace  routine 
CD 

CD  AUTHORS 

CD  your  average  programmrHer 

CDPp 

YOUR  AVERAGE  PROGRAMMRHER 

CD0b 

CD  your  average  programmer 

CD 

CD  DATE  UR1TTENZ* 

CD  t1oct?9 

CD 

OPTIONAL  SECTIONS?  (SEC1 , SEC2, . . .SECN/NONE) 

I>pur,var 
CD  PURPOSEZ* 

CD  tracer  prints  out  tracing  information  (at  entry  and  exit  to 

CD  subroutines)  depending  on  value  of  flag 

CD 

CD  VARIABLE  DICTIONARY*: 

CD  sname  -  input  parameter  (char  format),  contains  the  subroutine 
CD  name  to  be  traced 

CD  flag  -  indicator  to  tracer  of  what  action  is  to  be  done; 

CD* —  1;  enter  subroutine  sname 
CDS —  2;  exit  subroutine  sname 
CD 

OPTIONAL  SECTIONS?  (SEC1 ,SEC2,.. .SECN/NONE) 

I>none 

COHDECK  CALLS?  (NAME1 ,NANE2, . . . ,NANEN/NQNE> 

I>none 

SUBROUTINE  CALLS?  (Y/N) 
l>n 

OTHER  CODE?  (Y/N) 

I>V 

M>c  igo  is  caluclated  flag 

N>  if (flag  .It.  I.or.  falg  .gt.  2)  goto  999 

M>  goto(901 ,902) ,  flag 


N>  901  continue 

H>c  enter  subroutine 

H>  tsptr  *  tsptr  +  1 

H>  write (debug ,702)  tsptr ,7hentered,snarte 

H>  goto  1000 

N>  902  continue 

N>c  exit  subroutine 

H>  if  (tsptr  .le.  0)  tsptr  *  1 

H>  write (debug ,902)  tsptr f7hexi ted ,sna*e 

N>  702  fornatdh  ,=(1h-) ,a7,1x,a10) 

H>  tsptr  =  tsptr  -  1 
H>  1000  continue 
H> 

SUBROUTINE  CALLS?  (Y/N) 

I>n 

OTHER  CODE?  (Y/N) 

I>n 

NODULE  NANE? 

I>nain 

NODULE  TYPE?  (C,P,F,S) 

I>p 

FILE  DEFINITIONS?  (FI fF2t...FN/N0NE) 

I > input, output , debug-output 
TYPE  STATENENTS?  (Y/N) 

I>n 

DINENSION  STATEMENTS?  (Y/N) 

I>n 

ADS  -  REQUIRED  SECTIONS 


CD  TITLE*- 

CD  nain  -  a  sanple  nain  program 
CD 

CD  AUTHOR*- 

CD  y.a.  progrmeer 

CD 

CD  DATE  URITTENX- 

Cl  1200  a.d. 

CD 

OPTIONAL  SECTIONS?  (SEC1,8EC2,...SECN/N0NE) 
l>none 

CONDECK  CALLS?  (NAME1tNAHE2,...,NANEN/N0NE) 

I>filecon 

SUBROUTINE  CALLS?  (Y/N) 

i>y 

NANE? 

I>sub1 

PARAMETERS?  <P1fP2, ...PR/MONE) 

2  >parae1 , pari* 2 , par ae3 , par a#»4 , par anS  , paranA , paran? ,para*fi , par an9 , partial  0 
SUBROUTINE  CALLS?  (Y/N) 


-  m*J-  • 


J  >11 

OTHER  CODE?  <Y/N> 

i>y 

M>c  comments  and  other  code  can  be  interspersed  with  generated 
N>c  subroutine  calls 
M> 

SUBROUTINE  CALLS?  (Y/N) 

I>y 

NAME? 

I>sub2 

PARAMETERS?  (PI ,P2, .. .PN/NONE) 
l>none 

SUBROUTINE  CALLS?  <Y/N> 

I>n 

OTHER  CODE?  (Y/N) 

I>n 

MODULE  NAME? 

I>sub2 

MODULE  TYPE?  (C,P,F,S) 

l>s 

PARAMETER  LIST?  (PI ,P2, .. .PN/NONE ) 

1 >none 

TYPE  STATEMENTS?  (Y/N) 

I>n 

DIMENSION  STATEMENTS?  (Y/N) 

I>n 

ADS  -  REQUIRED  SECTIONS 


CD  TITLED 

CD  sub2  -  a  sample  subroutine 

CD 

CD  AUTHOR!* 

CD  y. a. programmer 

CD 

CD  DATE  URITTEN!* 

CD  any  date 

CD 

OPTIONAL  SECTIONS?  (SEC1 ,SEC2, . . .SECN/NONE) 

I > none 

CONDECK  CALLS?  < NANE t , NAME 2,..., NAMEN/NONE ) 

I>none 

SUBROUTINE  CALLS?  (Y/N) 

I>n 

OTHER  CODE?  (Y/N) 

I>n 

MODULE  NANE? 
l>Od 

♦♦FILECOH** 

THE  ABOVE  COMDECHS  MUST  BE  DEFINED  PRIOR  TO  INITIATING  A  RUN. 
ENTER  IS  TO  END  SESSION  AND  SAVE  FILES,  OR  CONTINUE  DEFINITIONS. 
I>f ilecom 

NODULE  TYPE?  (C,P,F,S) 
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1>C 

COMMONS  DEFINITION?  <T/N) 

i>y 

M>  common  /f ilecom/  input, output 

N> 

TYPE  STATEMENTS?  <Y/N> 

I>n 

DIMENSION  STATEMENTS?  ( Y/M) 

I>n 

ADS  -  REQUIRED  SECTIONS 


CD  COMMON  SLOCK  T1TLEZ* 

Cl  filecon  -  file  definition  common 
CD 

OPTIONAL  SECTIONS?  (SEC1 , SEC2, .SECM/NONE) 

I>none 

COMDECK  CALLS?  (NAME1 ,MAME2, . . . ,NAMEN/NONE) 
l>none 

OTHER  CODE?  <Y/N) 

I>n 

MODULE  NAME? 

I>0d 

OK.  JUST  A  SECOND  WHILE  1  SET  IT  ALL  T06ETHER. 

ASS  COMMANDS?  (Y/N) 

I>y 

M>title  a  sample  ads  run  generated  by  the  stub  generator 

**UARNING:  4400  TERMINATING  ;  SUPPLIED 
H>«p 

TITLE  A  SAMPLE  ADS  RUN  GENERATED  BY  THE  STUB  GENERATOR 

N>print  wide  "dump  for  all  commons; 

M>print  wide  dump  for  all  routines; 

N>draw  wide  tree; 

N>end; 

N> 

1  /JOB 

2  8TUSGEN , T30 , CM 1 30000 , P02 . 

3  USER,CER0I4,ILASTU.  JEANS. 

4  GET ,PR0FIL/UN*CER00S. 

5  GETf0LSPL«SAH0PL/UN«0,PU»TEST,NA. 

6  CALL, ,UPDTE(0PL«SAM0PL,UNB0,PU«TE8T,CT»P,UC»*) 

7  CALL, ,0SRT(0PL*SAM0PL,UN«0,PU«TEST ,CT*P,UC=*) 

G  CALL, , STAGS <0PL«8AM0PL,UN«0,PU«TEST,CT«P,UC**,INVT*SAMINV,MAST"8AMM AS) 
f  PURGE, SAMITES. 

10  PURGE, SANSTE1. 

It  PURGE, 8ANSCNI/NA. 

12  PURGE, SANTCNS/NA. 

13  EXIT , U • 

14  C0PT»F,UPL 1ST, OUTPUT. 

15  IF(F!LE< AI80UT ,L0) )C0PYSF ,ADS0UT , OUTPUT ,3. 

14  EXIT. 


AMY  CHANGES?  (Y/N) 

I>n 

DO  YOU  WISH  TO  RUN  THIS  JOB?  (Y/N) 

1>  n 

DO  YOU  WISH  TO  SAVE  THIS  DECK?  <Y/N) 

l>y 

08.31.35.  CONE  AGAIN! 

EXIT. 

C>get,sa«cntl 

C>listff*sa«cntl 

/JOB 

STUB6EN,T30, CMt 30000, P02. 

USER, CER08A, BLASTU.  JEANB. 

GET ,PR0FIL/UN*CER005. 

G£  T , OL  DPI »8AN0Pt /UN-0 , PU«  TE  S  T , NA . 

CALL,  ,UPDTE(0PL*SAH0Pl,UN*0,PU*TEST,CT*S,UC>*) 

CALL, ,OSRT(OPL*SAHOPL, UN*0,PUsTEST,CT=S,UC=*) 

CALL,,STADS<OPL*SAHOPL,UN»OfPU-TEST,CT*S,UC«*,INVT«SANINV,NAST-SAHNAS) 
PURGE, SAMITES. 

PURGE, SANDTE1. 

PURGE, SAMSCMD/MA. 

PURGE, SAMTCMD/MA. 

EXIT,U. 

COPYBF,UPLIST, OUTPUT. 

I F ( F I LE ( ADSOUT , LO ) ) COPYBF , ADSOUT , OUTPUT ,  3 . 

EXIT. 

/EOR 

/PACK 

/READ.SAHDTES 

/READ,SAHDTE1 

/EOR 

♦ID  SORT 

/EOR 

YANKttt 

/READ,SAHTCMD 

/EOR 

YANKttt 

/EOF 

*11  ADS 

*DF  CONN 

*BF  ROUT 

*BF  MAIN 

*DF  SUB2 

*BF  TRACER 

/EOR 

/REAI,8AN8CMD 

/EOF 

EOI  ENCOUNTERED.  •* 

Osubait  ,*ancntl , ti»ct rOOl 
07.30. IS.  80/07/1 ♦. LCIIIXZ 
C>byt 

JOB  PROCESSING  CCUS  110.781 
BYE  80/07/14.  07.34.30. 
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APPENDIX  C: 

INSTRUCTIONS  FOR  BEGINNING  A  STUB  GENERATOR  SESSION  ON  BCS 


To  begin  a  Stub  Generator  session  on  the  Cyber  175  at  BCS,  the  user  should  login  and  retrieve  the 
procedure  file: 

GET.PROFIL/  UN=CER005 
The  user  then  calls  the  interactive  procedure: 

CA1.L„JIST(M  ASTER=<master  account>.SYS=<system  prefix>, 
PW=<password>,TlD=<RJE  user  id» 

The  parameter  list  for  the  call  is: 

<master  account>:  The  ID  under  which  the  first  session  is/ was  executed  to  define  the  system  parameters. 

Required  so  that  the  Stub  Generator  can  access  and  maintain  required  permanent  files. 

<system  prefix>:  User-defined  system  identifier  (maximum  three  characters). 

<password>:  Password  to  be  associated  with  system-maintained  permanent  files.  Needed  to  allow  the 

Stub  Generator  to  access  and  maintain  the  proper  set  of  system  files. 

<RJE  user  id>:  User  ID  to  which  output  from  the  batch  job  is  to  be  sent.  This  does  not  have  to  be 

specified  if  the  user  will  not  be  beginning  a  batch  job  at  the  end  of  the  session 
(@D  command)  —  the  resulting  warning  can  be  ignored.  If  the  user  fails  to  enter  a  TID 
but  does  wish  to  begin  a  run,  the  job  should  be  aborted  when  requested  and  the  procedure 
restarted  with  the  proper  parameters.  The  Stub  Generator  submits  the  batch  job  from  the 
procedure;  thus,  an  incorrect  TID  cannot  be  fixed  from  within  the  program. 


APPENDIX  D: 

BATCH  JOB  OUTPUT 


This  appendix  lists  output  generated  by  the  batch  job  begun  by  the  Stub  Generator  session  shown  in 
Appendix  B.  The  OLDPL  listing  shows  the  contents  of  the  final  sorted  OLDPL.  Immediately  after  the  OLDPL 
listing  is  a  short  list  of  compile  errors.  These  errors  would  not  be  listed  if  the  batch  job  had  not  included  an  ADS 
run.  The  ADS  output  includes  an  echo  of  the  commands  received,  a  list  of  requested  reports,  and  the  requested 
tree  of  the  system  as  it  currently  exists. 
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A  SAMPLE  AOS  RUN  GENERATED  BY  THE  STUB  GENERATOR 


CERl  DISTRIBUTION 


Chief  of  Engineers 
ATTN:  Tech  Monitor 
ATTN:  OAEN-ASI-L  (2) 

ATTN:  OAEN-CCP 
AnN:  DAEN-CW 
ATTN:  DAEN-CWE 
ATTN:  OAEN-CWM-R 
AnN:  DAEN-CWQ 
AnN:  OAEN-CWP 
ATTN:  OAEN-MP 
ATTN:  DAEN-MPC 
ATTN-  DAEN-MPE 
ATTN:  DAfN-MPO 
ATTN:  DAEN-MPR-A 
AnN:  DATN-RD 
ATTN:  DAEN-ADC 
AnN:  DAEN-RDM 
ATTN:  DAEN-RN 
AnN:  DAEN-ZC 
AnN:  DAEN-ZCE 
ATTN:  OAEN-ZCI 
AnN:  OAEN-ZCM 

'JS  Army  Engineer  Districts 
AHN:  Library 
Alaska 
A1  Batin 
Albuquerque 
Bel  tl  More 
Buffalo 
Charleston 
Chicago 
Detroit 
Far  East 
Fort  Worth 
Galveston 
Huntington 
Jacksonville 
Japan 

Kansas  City 

Little  Rock 

Los  Angeles 

Louisville 

Memphis 

Mobile 

Nashville 

New  Orleans 

New  York 

Norfolk 

Omaha 

Philadelphia 

Pittsburgh 

Portland 

Riyadh 

Rock  Island 

Sacramento 

San  Francisco 

Savannah 

Seattle 

St.  Louis 

St.  Paul 

Tulsa 

Vicksburg 

Walla  Walla 

W1  Islington 

US  Amy  Engineer  Divisions 
ATTN:  Library 
Europe 
Huntsville 

Lower  Mississippi  Valley 
Middle  East 
Middle  East  (Rear) 

Missouri  River 
New  England 
North  Atlantic 
North  Central 
North  Pacific 
Ohio  River 
Pacific  Ocean 
South  Atlantic 
South  Pacific 
Southwestern 

Waterways  Experiment  Station 
ATTN:  Library 

Cold  Regions  Research  Engineering  Lab 
ATTN:  Library 

US  Government  Printing  Office 
Receiving  Section/Depository  Copies  (2) 


Engineering  Societies  Library 

New  York,  NY 

FESA,  ATTN:  library 

ETL.  ATTN-  Library 

Engr.  Studies  Center,  ATTN:  Library 

Inst,  for  Water  Res..  ATTN:  library 

Army  Instl.  and  Major  Activities  (CONUS) 
DARCON  -  Dir.,  Inst.,  I  Svcs. 

ATTN:  Fscll Ities  Engineer 
ARRADCOM 

Aberdeen  Proving  Ground 

Army  Mat  Is.  and  Mechanics  Res.  Ctr. 

Corpus  Chrlstl  Army  Depot 

Harry  Diamond  Laboratories 

Dugway  Proving  Ground 

Jefferson  Proving  Ground 

Fort  Monmouth 

Letterkenny  Army  Depot 

Natick  Research  and  Dev.  Ctr. 

New  Cumberland  Amy  Depot 
Pueblo  Amy  Depot 
Red  River  A  my  Depot 
Redstone  Arsenal 
Rock  Island  Arsenal 
Savanna  Amy  Depot 
Sharpe  Arruy  Depot 
Seneca  Amy  Oepot 
Tobytianna  Amy  Depot 
Tooele  Amy  Depot 
Watervllet  Arsenal 
Yuma  Proving  Ground 
White  Sands  Missile  Range 

FOR  SC  OH 

FORSCOM  Engineer.  ATTN:  AFEN-FE 
ATTN:  Facilities  Engineers 
Fort  Buchanan 
Fort  Bragg 
Fort  Campbell 
Fort  Carson 
Fort  Dtvens 
Fort  Drue 
Fort  Hood 

Fort  Indlantown  Gap 

Fort  Irwin 

Fort  Sam  Houston 

Fort  Lpwls 

Fort  McCoy 

Fort  McPherson 

Fort  George  G.  Meade 

Fort  Ord 

Fort  Polk 

Fort  Richardson 

Fort  Riley 

Presidio  of  San  Francisco 
Fort  Sheridan 
Fort  Stewart 
Fort  Walnwrlght 
Vancouver  Bks. 

TRA0OC 

HQ,  TRAOOC,  ATTN:  ATEN-FE 
ATTN:  Facilities  Engineer 
Fort  Balvolr 
Fort  Banning 
Fort  Bliss 
Carlisle  Barracks 
Fort  Chaffee 
Fort  01* 

Fort  Eustls 

Fort  Gordon 

Fort  Hamilton 

Fort  Benjamin  Harrison 

Fort  Jackson 

Fort  Knox 

Fort  Leavenworth 

Fort  Lee 

Fort  McClellan 

Fort  Monroe 

Fort  Rucker 

Fort  Sill 

Fort  Leonard  Wood 

1NSC0M  -  Ch,  instl.  Div. 

ATTN:  Facilities  Engineer 
Vint  Hill  Ferns  Station 
Arlington  Hall  Station 


MDW 

ATTN:  Facilities  Engineer 
Cameron  Station 
Fort  Losley  J.  McNair 
Fort  Myer 

NSC 

HQ  USAHSC.  AnN:  HSLO-F 
ATTN:  Tad  11  ties  Engineer 
Fttxslmons  Amy  Medical  Center 
Walter  Reed  Army  Medical  Center 

USACC 

AnN:  Facilities  Engineer 
Fort  Huacbuca 
Fort  Ritchie 

MTTK 

HQ,  AnN:  KTMC-SA 
ATTN:  Facilities  Engineer 
Oakland  Amy  Base 
Bayonne  MOT 
Sunny  Point  MOT 

US  Mill tary  Academy 
ATTN:  Facilities  Engineer 
ATTN:  Dept  of  Geography  A 
Computer  Science 

USAES,  Fort  Bel  voir,  VA 
AnN :  ATZA-DTE-EM 
ATTN :  ATZA-OTE-SU 
ATTN:  Engr.  Library 

Chief  Inst.  Div.,  IASA,  Rock  Island, 

USA  ARRCOM.  AnN:  Dir.,  Instl  A  Svc 
TAR COM.  Fac.  Div. 

TECOM,  AnN:  DRSTE-LG-F 
TSARCOM,  ATTN:  STSAS-F 
NARAD  COM,  ATTN:  ORDNA-F 
AMMRC,  AnN:  DRXNR-WE 

HQ,  XVI I I  Airborne  Corps  and 
Ft.  Bragg 
AHN:  AFZA-FE-EE 

HQ,  7th  Army  Training  Command 
AnN:  AEnG-DEH  (5) 

HQ  USAREUR  and  7th  Am* 

ODCS/Englneer 
AHN:  AEAEN-EH  (4) 

V  Corps 

ATTN:  AETVDEH  (5) 

VII  Corps 
ATTN:  AETSDEH  (5) 

21st  Support  Comaand 
ATTN:  AEREH  (5) 

US  Amy  Berlin 
AHN:  AEBA-EN  {2} 

US  Army  Southern  European  Task  Force 
ATTN:  AESE-ENG  (5) 

US  Angr  Installation  Support  Activity 
Europe 

ATTN:  AEUES-RP 

8th  USA,  Korea 
AnN:  EAFE 
Cdr,  Fac  Engr  Act  (8) 

AFE,  Tongsan  Area 
AFE,  2D  Inf  Olv 
AFE,  Area  II  Spt  Det 
AFE,  Cp  Himphreys 
AFE.  Pusan 
AFE,  Taegu 

DU  ATTN:  OU-WI 

USA  Japan  (USARJ) 

Ch,  FE  Div.  AJCN-FE 
Fac  Engr  (Honshu) 

Fac  Engr  (Okinawa) 

ROK/US  Confined  Forces  Comand 
ATTN :  EUS A-HHC -CFC/Engr 


Defense  Technical  Information  Center  WESTCON  _  416th  Engineer  Coi—nd 

ATT.:  DOA  (12)  ATT.:  Fiell1t1t»  En,1n..r  ATT.:  FicUltln  Englnnrln 

Fort  SHoftor 

Horton  AFI 
ATT.:  AF.CE-W/0H 


Team  Distribution 


Chief  of  Engineers 
ATTN:  DAEN-DSE 
ATTN:  DAEN-MPO-B 
ATTN:  DAEN-MPO-U 
ATTN:  DAEN-MPZ-A 
ATTN:  OAEN-MPR 
ATTN:  DAEN-ROl 
Dept  of  the  Army 
WASH  DC  20314 

Chief  of  Engineers 
ATTN:  OAEN-PMS 
Dept  of  the  Army 
WASH  DC  20314 
for  forwarding  to: 
International  Organization 
for  Standards 
Central  Secretariat 
1 ,  Rue  de  Varembe,  1211 
Geneva.  Switzerland 

US  Army  Materiel  Development 
and  Readiness  Command 
ATTN:  DRCOE-DK  (3) 

5001  Eisenhower  Ave 
Alexandria,  VA  22333 

Commander 

US  Army  Electronics  Command 
ATTN:  DRSEL-TL 41/Mr.  Tenzer 
Fort  Monmouth,  NJ  07  7  03 

000  ADP  Policy  Committee 
Assistant  Secretary  of  Oefense 
(Comptrol ler ) 

WASH  DC  20301 

DOD  Standardization  Area 
Computer  Aided  Design  and 
Numerical  Control 
Naval  Ship  Engineering  Center 
Hyattsvllle.  MO  20782 

DOD  Standardization  Program 
for  Information  Processing 
Standards  for  Computers  (IPSC) 
Directorate  of  Oata  Automation 
(AF/KRAX ) 

HQ,  USAF 
WASH  OC  20330 


Commander 

7th  Army  Combined  Arms  Training 
Center 

ATTN:  AETTM-HRD-EHD 
APO  New  York  09407 

US  Army  Engr  Oiv,  Europe 
ATTN:  Technical  Library  (3) 

APO  New  York  09757 

American  National  Standards 
Institute 
1430  Broadway 
New  York,  NY  10018 

ANSI  X3  Committee 
C/0  CBEMA 
1828  L  Street,  NW 
WASH  DC  20036 

DOD  Working  Group  on  Computer 
Documentation  Standards 
DOO/DOCN 
The  Pentagon 
WASH  DC  20301 

DOD  Working  Group  of  Computer- 
Generated  Military  Symbology 
DOD /DISPLAY 
The  Pentagon 
WASH  DC  20301 

Federal  Information  Processing 
Standards  Coordinating  and 
Advisory  Committee 
Dept  of  Commerce 
WASH  DC  20234 

Library  of  Congress 
Exchange  and  Gift  Division 
ATTN:  Federal  Documents  Section 
WASH  DC  20540 

Interagency  Coaanittee  on  Automatic 
Data  Processing 
National  Bureau  of  Standards 
WASH  DC  20234 

National  Bureau  of  Standards 
Institute  for  Computer  Sciences 
and  Technology 
WASH  DC  20234 


La writ,  Linda 
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1.  Electronic  data  processing  documentation.  I.  Baugh,  Jean.  II.  Title. 

III.  Series:  U.S.  Army  Construction  Engineering  Research  Laboratory.  Technical 
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